home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.4 Applications 1997 August / SGI IRIX 6.4 Applications 1997 August.iso / dist / arraysvcs.idb / usr / share / catman / u_man / cat1 / array.z / array
Encoding:
Text File  |  1997-02-07  |  11.4 KB  |  265 lines
  1.  
  2.  
  3.  
  4. aaaarrrrrrrraaaayyyy((((1111))))                                                              aaaarrrrrrrraaaayyyy((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      array - execute an array command
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      aaaarrrrrrrraaaayyyy [[[[ooooppppttttiiiioooonnnnssss............]]]] _c_o_m_m_a_n_d [_a_r_g_s...]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The _a_r_r_a_y command is used to execute the aaaarrrrrrrraaaayyyy ccccoooommmmmmmmaaaannnndddd specifed by
  16.      "_c_o_m_m_a_n_d _a_r_g_s..." on one or more machines in an array and display the
  17.      resulting output on stdout.  An array command is not necessarily the same
  18.      thing as a UNIX command.  It is passed to _a_r_r_a_y_d(1M), the array services
  19.      daemon, which is responsible for translating it to an actual UNIX command
  20.      and executing it on the machines that make up the array.  Several array
  21.      commands are available by default; these are described below.
  22.  
  23.      _a_r_r_a_y takes several options.  The first token on the command line that
  24.      does not constitute a valid option is assumed to mark the beginning of
  25.      the array command.  None of the remaining tokens will be examined by
  26.      _a_r_r_a_y, other than to pass them along as arguments to the array command
  27.      itself.
  28.  
  29.      The valid options include:
  30.  
  31.      _----_aaaa _a_r_r_a_y_n_a_m_e
  32.           Specifies the name of the array to which this command should be
  33.           directed.  If not specified, the array services daemon's default
  34.           destination will be used.
  35.  
  36.      _----_DDDD   When used with _----_ssss, indicates that the request should be sent
  37.           directly to the specified server, rather than forwarded to that
  38.           server by the local array services daemon.  This will fail on
  39.           systems that use array services authentication unless the ----KKKKllll and
  40.           ----KKKKrrrr options are also specified.  _----_DDDD is the default behavior under
  41.           normal circumstances (but see the description of the _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______FFFF_OOOO_RRRR_WWWW_AAAA_RRRR_DDDD
  42.           variable, below).
  43.  
  44.      _----_FFFF   When used with _----_ssss, indicates that the request should be forwarded to
  45.           the specified server via the local array services daemon, rather
  46.           than sent directly to it.  _----_FFFF will become the default behavior if
  47.           the value of the _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______FFFF_OOOO_RRRR_WWWW_AAAA_RRRR_DDDD environment variable begins with the
  48.           letter "Y" (as in "yes"; it may be in either upper or lower case).
  49.  
  50.      _----_gggg   Global command: indicates that the array command should be run in a
  51.           new global array session, that is, a new array session that has been
  52.           assigned a fresh global array session handle.
  53.  
  54.      _----_KKKK_llll _k_e_y
  55.           Use _k_e_y for the local authentication key when communicating directly
  56.           with a remote array services daemon.  _k_e_y is an unsigned 64-bit
  57.           value.  The default local key is obtained from the environment
  58.           variable _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______LLLL_OOOO_CCCC_AAAA_LLLL_KKKK_EEEE_YYYY; if that does not exist, no key is used.
  59.           The actual role played by _k_e_y depends on the authentication method
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaarrrrrrrraaaayyyy((((1111))))                                                              aaaarrrrrrrraaaayyyy((((1111))))
  71.  
  72.  
  73.  
  74.           used by array services in a particular configuration.  In general,
  75.           it is not used when communicating with an array services daemon on
  76.           the local machine.
  77.  
  78.      _----_KKKK_rrrr _k_e_y
  79.           Use _k_e_y for the remote authentication key when communicating
  80.           directly with a remote array services daemon.  _k_e_y is an unsigned
  81.           64-bit value.  The default remote key is obtained from the
  82.           environment variable _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______RRRR_EEEE_MMMM_OOOO_TTTT_EEEE_KKKK_EEEE_YYYY; if that does not exist, no
  83.           key is used.  The actual role played by _k_e_y depends on the
  84.           authentication method used by array services in a particular
  85.           configuration.  In general, it is not used when communicating with
  86.           an array services daemon on the local machine.
  87.  
  88.      _----_llll   Local request: indicates that the request should not be propagated
  89.           to other machines.  This could be useful for testing a new array
  90.           command.
  91.  
  92.      _----_pppp _p_o_r_t
  93.           Specifies the port address of the array services daemon.  Defaults
  94.           to the value of the "ARRAYD_PORT" environment variable if present,
  95.           or the standard port number of the "sgi-arrayd" service otherwise.
  96.  
  97.      _----_qqqq   Quiet: discard the output of the array command rather than sending
  98.           it to stdout.
  99.  
  100.      _----_ssss _s_e_r_v_e_r
  101.           Specifies the hostname or IP address of the array services daemon.
  102.           Defaults to the value of the "ARRAYD" environment variable if
  103.           present, or "localhost" otherwise.
  104.  
  105.      _----_tttt _v_a_l_u_e
  106.           Specifies the timeout value (in seconds) used for waiting on a
  107.           single array services request.  Most commands involve one array
  108.           services daemon requesting services from another array services
  109.           daemon, so it will typically take two times this many seconds before
  110.           the _a_r_r_a_y command itself will timeout.  The default is 15 seconds
  111.           (so most array commands will timeout if no response is received in
  112.           _3_0 seconds).
  113.  
  114.      _----_vvvv   Verbose messages: display additional progress messages.  Repeated
  115.           occurrences (either "-v -v ..." or "-vv...") increases the
  116.           verbosity, although this is generally only useful for debugging
  117.           _a_r_r_a_y_d itself.
  118.  
  119. UUUUSSSSIIIINNNNGGGG AAAA RRRREEEEMMMMOOOOTTTTEEEE AAAARRRRRRRRAAAAYYYY SSSSEEEERRRRVVVVIIIICCCCEEEESSSS DDDDAAAAEEEEMMMMOOOONNNN
  120.      Ordinarily, the _a_r_r_a_y command uses the array services daemon running on
  121.      the local machine for processing requests.  However, there are some
  122.      circumstances where it is useful to contact an array services daemon on
  123.      another machine instead, such as when a smaller machine, perhaps running
  124.      IRIX 5.3 and therefore not capable of running an array services daemon,
  125.      is used as a console interface for an array.  There are two ways to
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. aaaarrrrrrrraaaayyyy((((1111))))                                                              aaaarrrrrrrraaaayyyy((((1111))))
  137.  
  138.  
  139.  
  140.      accomplish this.  If it is necessary to use a remote array services
  141.      daemon only infrequently, the ----ssss _s_e_r_v_e_r option can be specified on the
  142.      command line to indicate the hostname of the server that should be
  143.      contacted.  However, if the remote daemon will be used frequently or
  144.      exclusively (such as in the case where the local machine is being used as
  145.      a console interface to an array, and not as a member of the array itself)
  146.      then an easier approach is to set the environment variable AAAARRRRRRRRAAAAYYYYDDDD to the
  147.      hostname of the remote server.  If the ----ssss option is not specified, then
  148.      the _a_r_r_a_y command will use the value of that variable (if it is set)
  149.      rather than trying to contact an array services daemon on the local
  150.      machine.
  151.  
  152. DDDDEEEEFFFFAAAAUUUULLLLTTTT AAAARRRRRRRRAAAAYYYY CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
  153.      The default array services configuration includes several simple array
  154.      commands:
  155.  
  156.      aaaarrrrrrrraaaayyyy kkkkiiiillllllll _A_S_H
  157.           Kills all processes in the array that belong to the array session
  158.           specified by the handle _A_S_H.
  159.  
  160.      aaaarrrrrrrraaaayyyy ppppssss
  161.           Shows the array session handle, machine name, process ID, owner, run
  162.           time and command line for every process in the array that has a
  163.           non-zero array session handle.
  164.  
  165.      aaaarrrrrrrraaaayyyy rrrreeeessssuuuummmmeeee _A_S_H
  166.           Resumes all processes in the array that belong to the array session
  167.           specified by the handle _A_S_H by sending them the SIGCONT signal.
  168.           Presumably this array session had been suspended earlier with aaaarrrrrrrraaaayyyy
  169.           ssssuuuussssppppeeeennnndddd.
  170.  
  171.      aaaarrrrrrrraaaayyyy ssssiiiiggggnnnnaaaallll _s_i_g _A_S_H
  172.           Sends signal _s_i_g to all processes in the array that belong to the
  173.           array session specified by the handle _A_S_H.  This is simply a more
  174.           general version of the kill/suspend/resume commands.
  175.  
  176.      aaaarrrrrrrraaaayyyy ssssuuuussssppppeeeennnndddd _A_S_H
  177.           Suspends all processes in the array that belong to the array session
  178.           specified by the handle _A_S_H by sending them the SIGTSTP signal.
  179.  
  180.      aaaarrrrrrrraaaayyyy uuuuppppttttiiiimmmmeeee
  181.           Equivalent to running the _u_p_t_i_m_e(1) command on each machine in the
  182.           array.
  183.  
  184.      aaaarrrrrrrraaaayyyy wwwwhhhhoooo
  185.           Shows the login name, current machine, origin machine and current
  186.           command for every logged-in user of the array.
  187.  
  188.      Note that the available array commands are controlled by the system
  189.      administrator, so some or all of these commands may not be present.
  190.      Other array commands may also be available.  Consult your system
  191.      adminstrator for more information.
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. aaaarrrrrrrraaaayyyy((((1111))))                                                              aaaarrrrrrrraaaayyyy((((1111))))
  203.  
  204.  
  205.  
  206. NNNNOOOOTTTTEEEESSSS
  207.      The array services daemon (_a_r_r_a_y_d(1M)) must be running on all machines
  208.      that are to execute an array command.  It does not necessarily have to be
  209.      running on the machine that executes _a_r_r_a_y if an alternate server was
  210.      specified in some way.
  211.  
  212. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  213.      arrayd(1M), arrayd.conf(4).
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.